Ce chapitre décrit plusieurs façons de réaliser une mise à jour de PrestaShop.
Mise à jour manuelle – Détails du processus
Ce guide vous donne le contrôle total du processus. Celui-ci a été appliqué par PrestaShop pour plusieurs versions majeures, et peut donc être appliqué sur des boutiques très anciennes.
Téléchargement de la version
La première étape consiste à télécharger la dernière version sur https://www.prestashop.com/.
Si vous passez à une autre version de PrestaShop 1.6, les fichiers de mise à jour se trouvent dans une liste d’archives dédiée.
Le téléchargement peut également se faire en ligne de commande, comme ici avec la version 1.7.3.2 :
Extraction d’archives
Extraire les fichiers de l’archive avec un outil comme 7zip
Note : à partir de la version 1.7.0.0 de PrestaShop, le paquet de mise à jour contient un fichier zip qui doit être extrait.
Sur un terminal Linux, vous pouvez utiliser la commande `unzip` :
dézipper prestashop-upgrade.zip && dézipper prestashop.zip
Une fois que vous avez les dossiers comme classes/, modules/, thèmes/, etc. vous pouvez passer à l’étape suivante.
Exemples de nettoyage de fichiers
Evitez d’écraser les ressources de production (images, conf …) avec les données par défaut. Ces dossiers peuvent être supprimés de la nouvelle version :
img/
passer outre/
Tous les autres fichiers présents dans la nouvelle version écraseront les fichiers existants. Toutes les modifications que vous avez apportées au code source original seront perdues (à propos, ce n’est pas recommandé, vous ne devez jamais modifier les fichiers de base).
Aussi, renommez le dossier « admin » pour qu’il corresponde au nom du dossier admin de votre boutique. Cela évitera une duplication non souhaitée du contenu de l’administration.
Activer le mode de maintenance
Le magasin sera désormais modifié. Comme cela peut entraîner un comportement inattendu pour vous et vos clients pendant la mise à niveau, nous vous recommandons vivement d’activer le mode de maintenance pendant la mise à niveau.
Cela peut être fait dans votre panneau d’administration :
Sur PrestaShop 1.7, dans Paramètres de la boutique > Général > Onglet Maintenance
Sur PrestaShop 1.6, dans Paramètres de l’atelier > Maintenance
L’ajout de votre adresse IP vous permettra d’accéder à votre magasin lorsqu’il est en mode de maintenance. Ainsi, vous pouvez vous assurer que tout fonctionne correctement avant de permettre à vos clients d’y accéder à nouveau.
Copie de fichier
Dans cette étape, nous « mettons à jour » les fichiers PrestaShop en copiant le contenu de la nouvelle version dans la boutique existante.
Note concernant le dossier « vendeur » : Les précédentes mises à jour de PrestaShop 1.7 ont montré que des conflits peuvent survenir lors de la fusion du nouveau dossier/vendeur avec l’ancien. Pour éviter ce problème, nous recommandons de supprimer ce dossier dans la boutique existante avant de copier le nouveau.
Sous Windows, copiez le contenu du nouveau dossier et collez-le dans le dossier de votre boutique. Vous serez averti que des fichiers existent déjà dans le dossier de destination. Choisissez « Ecraser » pour continuer.
Sur linux, la copie peut être effectuée dans votre terminal :
Mise à jour de la base de données
Une fois les fichiers copiés, la base de données de votre magasin est prête à être mise à jour.
Toutes les modifications à appliquer ont été définies dans le dossier « install », leur exécution peut se faire avec un script PHP spécifique.
Lorsque vous êtes prêt, exécutez le fichier `install/upgrade/upgrade.php`.
Cela peut se faire avec un navigateur, en accédant à l’adresse http://<shop_domain>/install/upgrade/upgrade.php, ou à partir de la ligne de commande de votre serveur :
php install/upgrade/upgrade.php
Dans les deux cas, un journal XML sera affiché. Le résultat peut être trouvé dans l’attribut résultat de la première balise <action> :
ok si les mises à jour ont été trouvées et exécutées
erreur si quelque chose a mal tourné
des informations sur les prochaines actions, en affichant les détails du processus
Journal d’exécution
Lorsque le script de mise à jour a trouvé des mises à jour à appliquer, les requêtes SQL exécutées seront listées avec leur résultat respectif.
Vous pouvez vérifier que chaque action est marquée comme « OK ». Si ce n’est pas le cas, des détails supplémentaires seront affichés après la demande, ce qui peut vous aider à résoudre le problème et à ré-exécuter la demande manuellement sur votre base de données. Dans certains cas, vous devrez peut-être restaurer la sauvegarde de votre base de données et recommencer à zéro.
Codes d’erreur
Un code d’erreur peut également être affiché. Chaque code est lié à un message décrit ici :
Erreur n°27 : La boutique utilise une version plus récente que le contenu fourni par le dossier d’installation.
Erreur #28 : La boutique est déjà à la version que vous essayez de mettre à jour.
Erreur #29 : Impossible de trouver la version actuelle. Vérifiez votre fichier de paramètres de base de données et la connexion à la base de données.
Erreur n°31 : Impossible de trouver le répertoire de mise à niveau dans le chemin d’installation, le dossier install/upgrade/sql existe-t-il et n’est pas vide ?
Erreur #32 : Aucune mise à jour ne doit être appliquée.
Erreur n°33 : Erreur lors du chargement d’un fichier de mise à niveau SQL. Vérifiez vos autorisations pour le dossier install/upgrade/sql.
Erreur n°40 : La version fournie dans le fichier install/install_version.php n’est pas valide.
Erreur n°43 : Erreur lors de la mise à jour d’un schéma de base de données en utilisant la doctrine.
Erreur n°44 : Erreur lors de la mise à jour des traductions.
Erreur n°45 : Erreur lors de l’activation du thème.
Nettoyage
Avant d’aller plus loin, il convient maintenant de nettoyer certaines choses.
Le dossier « install », utilisé pour la mise à jour de la base de données, n’est plus nécessaire et peut être supprimé en toute sécurité.